Приложение 1. Структура каталога установки и назначение каталогов и файлов
1.1. Структура каталогов установки
1.1.1. Общая информация
После установки на диске будет организована определенная структура каталогов, в которых расположены исполняемые файлы системы. Данный раздел описывает структуру каталогов установки, в зависимости от используемой операционной системы.
1.1.2. Для ОС Linux
Система будет установлена в каталог /opt/1cv8 (далее будем называть этот каталог корневым каталогом установки). В корневом каталоге установки создаются остальные каталоги и конфигурационные файлы:
● common ‑ данный каталог содержит общие файлы «1С:Предприятия». К ним относится программа установки драйвера ключа защиты и конфигурационный файл 1cescmn.cfg.
● conf ‑ данный каталог содержит конфигурационные файлы, необходимые для работы «1С:Предприятия».
● arm64 ‑ каталог установки системы «1С:Предприятие» для процессоров архитектуры ARM64. В данном каталоге расположены каталоги версии (описаны далее).
● e2kv4 ‑ каталог установки системы «1С:Предприятие» для процессоров архитектуры E2K. В данном каталоге расположены каталоги версии (описаны далее).
● i386 ‑ каталог установки системы «1С:Предприятие» для процессоров архитектуры x86. В данном каталоге расположены каталоги версии (описаны далее).
● x86_64 ‑ каталог установки системы «1С:Предприятие» для процессоров архитектуры x86-64. В данном каталоге расположены каталоги версии (описаны далее).
● В каталоге конкретной архитектуры расположен каталог вида A.B.C.D. Данный каталог содержит файлы конкретной версии «1С:Предприятия». В дальнейшем данный каталог будет называться каталогом версии. Полный путь к каталогу будет выглядеть следующим образом:
● Архитектура ARM64: /opt/1cv8/arm64/A.B.C.D.
● Архитектура E2K: /opt/1cv8/e2kv4/A.B.C.D.
● Архитектура x86: /opt/1cv8/i386/A.B.C.D.
● Архитектура x86-64: /opt/1cv8/x86_64/A.B.C.D.
Следует отметить, что программа установки позволяет устанавливать одновременно несколько версий системы программ «1С:Предприятие». В этом случае в каталоге соответствующей архитектуры будет расположено несколько каталогов версий. Так, в случае установки версий 8.3.18.100 и 8.3.18.150 (номера версий ‑ условные), будут присутствовать два каталога версии с именами 8.3.18.100 и 8.3.18.150. Каждый каталог версии содержит в себе все файлы (кроме файла 1cestart), присущие этой версии, а именно: собственно исполняемые файлы, сопроводительные файлы, лицензии к используемым программным продуктам и т. д. Каталог версии имеет следующую структуру:
● conf ‑ содержит конфигурационные файлы конкретной версии или файл conf.cfg. Описание файла conf.cfg см. здесь.
● distr ‑ каталог размещения дистрибутивов клиентских приложений (подробнее см. здесь).
● jre ‑ каталог размещения Java Runtime Environment (JRE).
● docs ‑ данный каталог содержит сопроводительные файлы на русском и английском языках. Состав файлов может меняться от версии к версии.
● licenses ‑ содержит лицензионное соглашение на «1С:Предприятие» на русском (файл 1CEnterpise_ru.htm) и английском языках (файл 1CEnterpise_en.htm), а также лицензионные соглашения на используемые программные компоненты сторонних производителей (этот список может меняться от версии к версии).
● readme ‑ данный каталог содержит файлы readme на языках локализации платформы.
● ExtDst ‑ содержит дополнительные утилиты, предназначенные для использования совместно с системой «1С:Предприятие».
Следует отметить, что систему «1С:Предприятие» предыдущих версий (до версии 8.3.18) можно вручную разместить в вышеописанной структуре каталогов. Для этого необходимо корректно указать каталоги конкретных версий. После такого размещения программы запуска начнут использовать предыдущие версии для автоматического подбора запускаемых клиентских приложений.
1.1.3. Для ОС macOS
Система будет установлена в каталог /opt/1cv8 (далее будем называть этот каталог корневым каталогом установки). В корневом каталоге установки создаются остальные каталоги и конфигурационные файлы:
● common ‑ данный каталог содержит общие файлы «1С:Предприятия». К ним относится программа установки драйвера ключа защиты и конфигурационный файл 1cescmn.cfg.
● conf ‑ данный каталог содержит конфигурационные файлы, необходимые для работы «1С:Предприятия».
A.B.C.D ‑ данный каталог содержит файлы конкретной версии «1С:Предприятия». В дальнейшем данный каталог будет называться каталогом версии. Следует отметить, что программа установки позволяет устанавливать одновременно несколько версий системы программ «1С:Предприятие». В этом случае в корневом каталоге установки будет расположено несколько каталогов версий. Так, в случае установки версий 8.3.24.100 и 8.3.24.150 (номера версий ‑ условные) будут присутствовать два каталога с именами 8.3.24.100 и 8.3.24.150. Каждый каталог версии содержит в себе все файлы (кроме файла 1cestart), присущие этой версии, а именно: собственно исполняемые файлы, сопроводительные файлы, лицензии к используемым программным продуктам и т. д. Каталог версии имеет следующую структуру:
● conf ‑ содержит конфигурационные файлы конкретной версии или файл conf.cfg. Описание файла conf.cfg см. здесь.
● distr ‑ каталог размещения дистрибутивов клиентских приложений (подробнее см. здесь).
● docs ‑ данный каталог содержит сопроводительные файлы на русском и английском языках. Состав файлов может меняться от версии к версии.
● licenses ‑ содержит лицензионное соглашение на «1С:Предприятие» на русском (файл 1CEnterpise_ru.htm) и английском языках (файл 1CEnterpise_en.htm), а также лицензионные соглашения на используемые программные компоненты сторонних производителей (этот список может меняться от версии к версии).
● readme ‑ данный каталог содержит файлы readme на языках локализации платформы.
1.1.4. Для ОС Windows
Каталог установки системы, который используется по умолчанию, зависит от выбранного режима установки системы. Этот каталог далее будет называться корневым каталогом установки:
● Установка «для компьютера»:
● 32-разрядная система в 64-разрядной ОС: %PROGRAMFILES(x86)%\1cv8.
● В остальных случаях: %PROGRAMFILES%\1cv8.
● Установка «для пользователя»:
● 32-разрядная система в 32-разрядной ОС: %LOCALAPPDATA%\Programs\1cv8.
● 32-разрядная система в 64-разрядной ОС: %LOCALAPPDATA%\Programs\1cv8_x86.
● 64-разрядная система в 64-разрядной ОС: %LOCALAPPDATA%\Programs\1cv8_x64.
В корневом каталоге установки создаются остальные каталоги и конфигурационные файлы:
● common ‑ данный каталог содержит общие файлы «1С:Предприятия». К ним относится программа запуска 1cestart, программа установки драйвера ключа защиты, оснастка консоли управления для администрирования кластера серверов «1С:Предприятия» (1CV8 Servers.msc), библиотека пиктограммы файлов «1С:Предприятия» для нужд операционной системы.
● conf ‑ данный каталог содержит конфигурационные файлы, необходимые для работы «1С:Предприятия».
● srvinfo ‑ рабочий каталог центрального сервера. Содержит данные кластера серверов в том случае, если сервер «1С:Предприятия» установлен как сервис ОС Windows.
● A.B.C.D ‑ данный каталог содержит файлы конкретной версии «1С:Предприятия». В дальнейшем данный каталог будет называться каталогом версии. Следует отметить, что программа установки позволяет устанавливать одновременно несколько версий системы программ «1С:Предприятие». В этом случае в корневом каталоге установки будет расположено несколько каталогов версий. Так, в случае установки версий 8.3.24.100 и 8.3.24.150 (номера версий ‑ условные) будут присутствовать два каталога с именами 8.3.24.100 и 8.3.24.150. Каждый каталог версии содержит в себе все файлы (кроме файла 1cestart), присущие этой версии, а именно: собственно исполняемые файлы, сопроводительные файлы, лицензии к используемым программным продуктам и т. д. Каталог версии имеет следующую структуру:
● bin ‑ содержит исполняемые файлы версии (каталог исполняемых файлов).
● bin\conf ‑ содержит конфигурационные файлы конкретной версии или файл conf.cfg, который содержит путь к общему каталогу конфигурационных файлов (по умолчанию каталог conf корневого каталога установки). Описание файла conf.cfg см. здесь.
● bin\distr ‑ каталог размещения дистрибутивов клиентских приложений (подробнее см. здесь).
● bin\jre ‑ каталог размещения Java Runtime Environment (JRE).
● bin\dmf ‑ содержит файлы, необходимые для функционирования оптимизированного механизма обновления конфигурации базы данных.
● docs ‑ данный каталог содержит сопроводительные файлы на русском и английском языках. Состав файлов может меняться от версии к версии.
● licenses ‑ содержит лицензионное соглашение на «1С:Предприятие» на русском (файл 1CEnterpise_ru.htm) и английском языках (файл 1CEnterpise_en.htm), а также лицензионные соглашения на используемые программные компоненты сторонних производителей (этот список может меняться от версии к версии).
● readme ‑ данный каталог содержит файлы readme на языках локализации платформы.
Некоторые каталоги при установке всегда находятся в фиксированном месте файловой системы, вне зависимости от того, какой каталог выбран при установке системы:
● Каталоги common и conf всегда располагаются в следующих каталогах:
● Установка «для компьютера»:
● 32-разрядная система в 64-разрядной ОС: %PROGRAMFILES(x86)%\1cv8.
● В остальных случаях: %PROGRAMFILES%\1cv8.
● Установка «для пользователя»:
● 32-разрядная система в 32-разрядной ОС: %LOCALAPPDATA%\Programs\1cv8.
● 32-разрядная система в 64-разрядной ОС: %LOCALAPPDATA%\Programs\1cv8_x86.
● 64-разрядная система в 64-разрядной ОС: %LOCALAPPDATA%\Programs\1cv8_x64.
● Каталог srvinfo создается программой установки только в том случае, если во время установки выбран запуск кластера серверов «1С:Предприятие» в виде сервиса ОС Windows. Такая установка возможна только в том случае, если система «1С:Предприятие» устанавливается в режиме «для компьютера». В этом случае каталог srvinfo будет создан в следующих каталогах:
● В случае совпадения разрядности «1С:Предприятие» и операционной системы ‑ в каталоге %PROGRAMFILES%\1cv8.
● В случае использования 32-разрядной версии «1С:Предприятие» на 64-разрядной версии операционной системы ‑ в каталоге %PROGRAMFILES(x86)%\1cv8.
1.2. Назначение файлов
1.2.1. Общая информация
Данный раздел содержит описание некоторых файлов, входящих в состав системы «1С:Предприятие».
1.2.2. 1cestart
Программа запуска системы «1С:Предприятие». С помощью программы запуска можно запустить все виды клиентов (толстый клиент, тонкий клиент, веб-клиент), конфигуратор.
Совет. Если программа запуска располагается в сетевом каталоге (см. здесь), то рекомендуется использовать эту программу из самой новой версии, которая планируется к установке из этого сетевого каталога.
Расположение файла:
● Для ОС Windows:
● Установка «для компьютера»:
● 32-разрядная система в 64-разрядной ОС: %PROGRAMFILES(x86)%\1cv8\common.
● В остальных случаях: %PROGRAMFILES%\1cv8\common.
● Установка «для пользователя»:
● 32-разрядная система в 32-разрядной ОС: %LOCALAPPDATA%\Programs\1cv8\common.
● 32-разрядная система в 64-разрядной ОС: %LOCALAPPDATA%\Programs\1cv8_x86\common.
● 64-разрядная система в 64-разрядной ОС: %LOCALAPPDATA%\Programs\1cv8_x64\common.
● Для ОС Linux:
● При совпадении разрядности ОС и устанавливаемого приложения: /opt/1cv8/common.
● При несовпадении разрядности ОС и устанавливаемого приложения ‑ не устанавливается.
● Для ОС macOS: в каталоге исполняемых файлов конкретной версии.
1.2.3. 1cv8s
Интерактивная программа запуска системы «1С:Предприятие» конкретной версии. Позволяет запустить все виды клиентов (толстый клиент, тонкий клиент, веб-клиент), конфигуратор.
Расположение файла:
● Для ОС Windows:
● Установка «для компьютера»:
● 32-разрядная система в 64-разрядной ОС: %PROGRAMFILES(x86)%\1cv8\A.B.C.D\bin.
● В остальных случаях: %PROGRAMFILES%\1cv8\A.B.C.D\bin.
● Установка «для пользователя»:
● 32-разрядная система в 32-разрядной ОС: %LOCALAPPDATA%\Programs\1cv8\A.B.C.D\bin.
● 32-разрядная система в 64-разрядной ОС: %LOCALAPPDATA%\Programs\1cv8_x86\A.B.C.D\bin.
● 64-разрядная система в 64-разрядной ОС: %LOCALAPPDATA%\Programs\1cv8_x64\A.B.C.D\bin.
● Для ОС Linux: в каталоге исполняемых файлов конкретной версии.
● Для ОС macOS: в каталоге исполняемых файлов конкретной версии.
1.2.4. 1cv8
Исполняемый файл толстого клиента или конфигуратора.
Не может запустить тонкий клиент и веб-клиент.
Расположение файла:
● Для ОС Windows:
● Установка «для компьютера»:
● 32-разрядная система в 64-разрядной ОС: %PROGRAMFILES(x86)%\1cv8\A.B.C.D\bin.
● В остальных случаях: %PROGRAMFILES%\1cv8\A.B.C.D\bin.
● Установка «для пользователя»:
● 32-разрядная система в 32-разрядной ОС: %LOCALAPPDATA%\Programs\1cv8\A.B.C.D\bin.
● 32-разрядная система в 64-разрядной ОС: %LOCALAPPDATA%\Programs\1cv8_x86\A.B.C.D\bin.
● 64-разрядная система в 64-разрядной ОС: %LOCALAPPDATA%\Programs\1cv8_x64\A.B.C.D\bin.
● Для ОС Linux: в каталоге исполняемых файлов конкретной версии.
● Для ОС macOS: в каталоге исполняемых файлов конкретной версии.
1.2.5. 1cv8с
Исполняемый файл тонкого клиента.
Расположение файла:
● Для ОС Windows:
● Установка «для компьютера»:
● 32-разрядная система в 64-разрядной ОС: %PROGRAMFILES(x86)%\1cv8\A.B.C.D\bin.
● В остальных случаях: %PROGRAMFILES%\1cv8\A.B.C.D\bin.
● Установка «для пользователя»:
● 32-разрядная система в 32-разрядной ОС: %LOCALAPPDATA%\Programs\1cv8\A.B.C.D\bin.
● 32-разрядная система в 64-разрядной ОС: %LOCALAPPDATA%\Programs\1cv8_x86\A.B.C.D\bin.
● 64-разрядная система в 64-разрядной ОС: %LOCALAPPDATA%\Programs\1cv8_x64\A.B.C.D\bin.
● Для ОС Linux: в каталоге исполняемых файлов конкретной версии.
● Для ОС macOS: в каталоге исполняемых файлов конкретной версии.
1.2.6. 1cv8a
Утилита административной консоли. Описание утилиты см. здесь.
Расположение файла:
● Для ОС Windows: в каталоге исполняемых файлов конкретной версии.
● Для ОС Linux: в каталоге исполняемых файлов конкретной версии.
● Для ОС macOS: в каталоге исполняемых файлов конкретной версии.
1.2.7. ragent, rmngr, rphost
Исполняемые файлы сервера «1С:Предприятия». Устройство сервера «1С:Предприятие» описано в книге.
Расположение файлов:
● Для ОС Windows: в каталоге исполняемых файлов конкретной версии.
● Для ОС Linux: в каталоге исполняемых файлов конкретной версии.
● Для ОС macOS: отсутствуют.
1.2.8. crserver
Сервер хранилища конфигурации. Работа с хранилищем конфигурации описано в книге.
Расположение файла:
● Для ОС Windows: в каталоге исполняемых файлов конкретной версии.
● Для ОС Linux: в каталоге исполняемых файлов конкретной версии.
● Для ОС macOS: отсутствует.
1.2.9. dbgs
Сервер отладки системы «1С:Предприятие». Отладка прикладных решений описана в книге.
Расположение файла:
● Для ОС Windows: в каталоге исполняемых файлов конкретной версии.
● Для ОС Linux: в каталоге исполняемых файлов конкретной версии.
● Для ОС macOS: в каталоге исполняемых файлов конкретной версии.
1.2.10. dbda
Дата акселератор. Работает только в составе 64-разрядного кластера серверов «1С:Предприятия». Предназначен для ускорения выполнения сложных аналитических отчетов. Подробнее описан в книге.
Расположение файла:
● Для ОС Windows: в каталоге исполняемых файлов конкретной версии.
● Для ОС Linux: в каталоге исполняемых файлов конкретной версии.
● Для ОС macOS: отсутствует.
1.2.11. webinst
Утилита настройки публикации веб-клиента на веб-сервере (подробнее см. здесь).
Расположение файла:
● Для ОС Windows: в каталоге исполняемых файлов конкретной версии.
● Для ОС Linux: в каталоге исполняемых файлов конкретной версии.
● Для ОС macOS: отсутствует.
1.2.12. chdbfl
Утилита тестирования базы данных файлового варианта (подробнее см. здесь).
Расположение файла:
● Для ОС Windows: в каталоге исполняемых файлов конкретной версии.
● Для ОС Linux: в каталоге исполняемых файлов конкретной версии.
● Для ОС macOS: в каталоге исполняемых файлов конкретной версии.
1.2.13. cnvdbfl
Утилита конвертирования базы данных файлового варианта (подробнее см. здесь).
Расположение файла:
● Для ОС Windows: в каталоге исполняемых файлов конкретной версии.
● Для ОС Linux: в каталоге исполняемых файлов конкретной версии.
● Для ОС macOS: в каталоге исполняемых файлов конкретной версии.
1.2.14. ci
Утилита контроля целостности. Подробное описание утилиты см. здесь.
Расположение файла:
● Для ОС Windows: в каталоге исполняемых файлов конкретной версии.
● Для ОС Linux: в каталоге исполняемых файлов конкретной версии.
● Для ОС macOS: отсутствует.
1.2.15. dumper
Утилита для формирования дампов аварийного завершения. Данная утилита используется при указании атрибута externaldump="true" в файле logcfg.xml (подробнее см. здесь).
Расположение файла:
● Для ОС Windows: в каталоге исполняемых файлов конкретной версии.
● Для ОС Linux: отсутствует.
● Для ОС macOS: отсутствует.
1.2.16. v7cnv.exe
Конвертер информационных баз из версии «1С:Предприятия 7.7» в текущую версию. Конвертер описан в книге 1С:Предприятие 8.3. "Руководство разработчика".
Расположение файла:
● Для ОС Windows: в каталоге исполняемых файлов конкретной версии.
● Для ОС Linux: отсутствует.
● Для ОС macOS: отсутствует.
1.2.17. RegMSC.cmd
Командный файл для регистрации утилиты администрирования кластера серверов «1С:Предприятия» конкретной версии (расположен в каталоге исполняемых файлов конкретной версии).
Расположение файла:
● Для ОС Windows: в каталоге исполняемых файлов конкретной версии.
● Для ОС Linux: отсутствует.
● Для ОС macOS: отсутствует.
1.2.18. 1ceunt.dll
Библиотека пиктограмм, которыми операционная система отображает различные типы файлов системы «1С:Предприятие». Данная библиотека является общей для всех версий системы. Регистрация этой библиотеки (и привязка пиктограмм к типам файлов) выполняется при первой установке на компьютере «1С:Предприятия». Отмена регистрации библиотеки (и удаление привязки пиктограмм к типам файлов) выполняется при удалении с компьютера последней версии «1С:Предприятия».
Расположение файла:
● Для ОС Windows: в каталоге common корневого каталога установки.
● Для ОС Linux: отсутствует.
● Для ОС macOS: отсутствует.
1.3. Конфигурационные файлы: расположение и поиск
1.3.1. Общая информация
Конфигурационные файлы, которые используются при работе системы «1С:Предприятие» (logcfg.xml, nethasp.ini и т. д.), могут располагаться в различных местах файловой системы. При этом определен порядок поиска этих конфигурационных файлов в различных каталогах. Такой порядок поиска конфигурационных файлов позволяет:
● Формировать единые конфигурационные файлы для всех версий и компонент, установленных на компьютере. Для этого конфигурационные файлы должны располагаться только в каталоге conf корневого каталога установки.
● Формировать конфигурационные файлы отдельно для каждой версии, установленной на компьютере. Для этого конфигурационные файлы должны располагаться только в каталоге bin\conf конкретной версии.
● Формировать различные конфигурационные файлы для разных компонентов (для клиентского приложения и сервера «1С:Предприятия», функционирующего под другим пользователем системы) любой версии, работающих на компьютере. Для этого конфигурационные файлы должны располагаться в каталогах конфигурационных файлов, которые доступны для всех пользователей компьютера (перечень таких каталогов зависит от используемой операционной системы и варианта установки системы «1С:Предприятие»).
● Использовать комбинации перечисленных способов для различных конфигурационных файлов.
1.3.2. Для ОС Linux
В ОС Linux файлы могут располагаться в следующих местах (в порядке поиска):
● Каталог conf конкретной версии: /opt/1cv8/arch/A.B.C.D/conf.
● Каталог conf корневого каталога установки: /opt/1cv8/conf.
● Каталог ~/.1cv8/1C/1cv8/conf (~ ‑ домашний каталог пользователя, от имени которого работает клиентское приложение «1С:Предприятия»).
● Каталог, указанный в качестве значения параметра ConfLocation конфигурационного файла конкретной версии. Подробнее о формате файла conf.cfg см. здесь.
1.3.3. Для ОС macOS
В ОС macOS конфигурационные файлы могут располагаться в следующих местах (в порядке поиска):
● Каталог conf конкретной версии: /opt/1cv8/A.B.C.D/conf.
● Каталог conf корневого каталога установки: /opt/1cv8/conf.
● Каталог ~/.1cv8/1C/1cv8/conf (~ ‑ домашний каталог пользователя, от имени которого работает клиентское приложение «1С:Предприятия»).
● Каталог, указанный в качестве значения параметра ConfLocation файла conf.cfg из каталога conf конкретной версии. Подробнее о формате файла conf.cfg см. здесь.
1.3.4. Для ОС Windows
В ОС Windows файлы могут располагаться в следующих местах (в порядке поиска):
● Каталог bin\conf конкретной версии:
● Установка «для компьютера»:
● 32-разрядная система в 64-разрядной ОС: %PROGRAMFILES(x86)%\1cv8\A.B.C.D\bin\conf.
● В остальных случаях: %PROGRAMFILES%\1cv8\A.B.C.D\bin\conf.
● Установка «для пользователя»:
● 32-разрядная система в 32-разрядной ОС: %LOCALAPPDATA%\Programs\1cv8\A.B.C.D\bin\conf.
● 32-разрядная система в 64-разрядной ОС: %LOCALAPPDATA%\Programs\1cv8_x86\A.B.C.D\bin\conf.
● 64-разрядная система в 64-разрядной ОС: %LOCALAPPDATA%\Programs\1cv8_x64\A.B.C.D\bin\conf.
● Каталог %LOCALAPPDATA%\1C\1cv8\conf пользователя, от имени которого работает система.
● Каталог, указанный в качестве значения параметра ConfLocation файла conf.cfg из каталога bin\conf конкретной версии. Подробнее о формате файла conf.cfg см. здесь.
● Каталог %ALLUSERSPROFILE%\1C\1cv8\conf.
Примечание. При установке системы конфигурационные файлы записываются в каталог conf корневого каталога установки, и данный путь записывается в файл bin\conf\conf.cfg устанавливаемой версии.